home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_util / wg960530.zip / PATCH.DOC < prev    next >
Text File  |  1996-05-30  |  5KB  |  124 lines
  1.  
  2.      W...W
  3.      W.W.W
  4.      .W.W.
  5.  
  6.      WaterGate
  7.      Mailprocessor for Fidonet & Usenet
  8.      Patch files
  9.  
  10.      (c) Copyright 1993-1996 WaterLine Software Development
  11.                              All Rights Reserved
  12.  
  13.  
  14. May 30th, 1996
  15.  
  16. This document explains how patch files for WaterGate work, how you
  17. can get them and how to apply them.
  18.  
  19.  
  20. About patches
  21. -------------
  22.  
  23. If a small bug has been fixed in for example wtrgate.exe, then I
  24. don't have to release a new version and I neither have to send
  25. everybody a new executable of over 300kB.
  26.  
  27. Instead, I create a so call "patch" file that can be used to upgrade
  28. wtrgate.exe to the new version. The patch file must be applied with
  29. the program UNDIF.EXE that can be found in the distribution archive.
  30.  
  31. The patch file is a binary file with the extension .DIF. It contains
  32. a list of all the changes that have to be made to the current
  33. wtrgate.exe to get the new one. This is basically a list of "copy
  34. this part, modify that byte, move this here, move that there" and
  35. so on.
  36.  
  37. The patch file must always be applied to the correct version of the
  38. executable. I always state in the upgrade.doc that accompanies the
  39. .DIF file to which .exe file you have to apply to patch. Most of
  40. the times this will be the latest version. If I release patch 1,
  41. you have to apply it to the .exe file from the distribution archive.
  42. If I release patch 2, you have to apply it to the patch 1 executable.
  43.  
  44. The patches are called P1, P2, P3 and so on and the version numbers
  45. change accordingly: from 0.91 to 0.91.p1, 0.91.p2 and so on. The
  46. distribution archives for the patches are names wg<version>P<patch>,
  47. for example wg091p1.zip for patch level 1 for WaterGate version 0.91.
  48. The files inside the patch archive are always called wtrgate.dif for
  49. wtrgate.exe, wtrutil.dif for wtrutil.exe and so on.
  50.  
  51. The patches not always upgrade all the executables. Some only upgrade
  52. wtrgate.exe other upgrade wtrconf.exe and wtrutil.exe as well.
  53. Special patches for WtrConf, wtrUtil and WtrTest are named wc, wu
  54. and wt instead of wg. For example wu090p8, which only upgraded
  55. WtrUtil. Patches can upgrade the helpfile (wtrgate.hlp) as well.
  56. This patch is mostly call wtrhelp.dif.
  57.  
  58.  
  59. Where can I get the patch files?
  60. --------------------------------
  61.  
  62. You should be able to find the patch files in the same place where
  63. you found WaterGate. The first places to go are ftp.sbbs.se, 1:320/42
  64. and 2:200/111. People having WaterGate on-line for file request are
  65. kindly asked to allow the patches to be requested by their original
  66. filename.
  67.  
  68. As a last resort, you can always get the patches from me via e-mail
  69. by sending a message to <patch archive name>-req@wsd.wline.se, for
  70. example wg090p1-req@wsd.wline.se. Sometimes the patches are so big
  71. that I do not appreciate it if loads of people request it over
  72. my UUCP dialup connection. If the patch is small, I don't care.
  73.  
  74.  
  75. How to apply a patch
  76. --------------------
  77.  
  78. When you have received a patch, you unzip the archive and find at
  79. least two files: one upgrade.doc which you must read very carefully
  80. and one or more .dif files.
  81.  
  82. Read the upgrade.doc to find out which executables to upgrade and
  83. copy these in a new directory. Also copy the .dif files and the
  84. program undif.exe into that same directory. Then, type the following
  85. command to start the patching process:
  86.  
  87. UNDIF *
  88.  
  89. The undif program will now search for all .DIF file, check the
  90. executable for the correct version and then apply the patch. The
  91. executable is not renamed but keeps it original name. No backup
  92. is made.
  93.  
  94. When all executables have been patches sucessfully, you should
  95. not just copy them in place and run them. First make a backup
  96. of your WaterGate directory. Make sure to backup the executables
  97. and the database file, so you can always return to an older
  98. version if the need would arrise.
  99.  
  100. When you have made the backup, then copy the new executables into
  101. the WaterGate directory.
  102.  
  103. Some patches come with an upgrade.exe program which upgrades your
  104. database files as well. If so, you have to run this program first
  105. before you can use the new executables. If you run more than one
  106. configuration (in different directories), then make sure you run
  107. upgrade.exe in each of these directories to upgrade all the
  108. database files.
  109.  
  110. Before you continu, go back to upgrade.doc to see if the changes
  111. made to the executables or databases might impact your system and
  112. you perhaps need to make other chnges as well.
  113.  
  114. You are now ready to run the new executables. First run each of
  115. the executables to make sure they function and don't crash your
  116. system.
  117.  
  118. If everything seems oke, then start to test the new changes that
  119. were made. You have sucessfully patches your WaterGate system!
  120.  
  121. Mail me if you have any questions or comments to this document.
  122.  
  123. Ramon     ramon@wsd.wline.se
  124.